home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 201-225 / disk_203 / examples / contents < prev    next >
Text File  |  1992-05-06  |  7KB  |  119 lines
  1. ======================THE SON OF EXAMPLES1==========================
  2.  
  3.  This disc contains mostly assembly and C code examples written by Jim Fiore
  4. and Jeff Glatt (Jim wrote the C stuff, I wrote the assembly). It also contains
  5. assembly language versions of some C examples from Commodore or Fred Fish
  6. discs as well.
  7.  
  8. Speechtoy: The classic Commodore C example of using gadgets, converted to
  9.            assembly language and optimized. Asm conversion by Jeff Glatt.
  10.  
  11. AudioDev: An executable only. This program replaces the official audio device
  12.           (loaded from KickStart) with an optimized, assembly version. The
  13.           official version (33.4) on KickStart 1.2 has several bugs, and is
  14.           written mostly in C. The document, Audio.DOC, explains about the
  15.           program, and the program itself, NewAudio, needs to be executed
  16.           (once only) after you boot. Asm by Jeff Glatt.
  17.  
  18. Task: This is an assembly version of a Commodore C example to create a
  19.       subtask using the amiga.lib function, CreateTask. Conversion JG
  20.  
  21. FileIO: R.J. Mical, the C programmer who wrote much of the Amiga's intuition,
  22.         wrote a file requester which was distributed on Fish Disc 107. There
  23.         were some other modules as well. They all comprised something called
  24.         ProSuite volume 1. Jim and I thought that the functionality of the
  25.         requester was exactly what we were looking for (with a few minor
  26.         changes), but the C code was much too big and slow. Jim made some
  27.         modifications to the C code (mostly imagery) and I converted it to
  28.         assembly, and turned it into a disk-based library that could be
  29.         opened and called by many tasks (the original needed to be linked
  30.         with each separate task). The code itself went from a whopping 15K+
  31.         to 10K. Furthermore, many customized options/functions were added
  32.         as well as enhanced error handling.
  33.         Now, there need only be one copy of the requester code in memory
  34.         instead of 15K per task. I have modified the original documentation
  35.         to reflect the new changes, created assembly and BASIC examples
  36.         to demo using the library, and modified the original C example to
  37.         use this library. The original C code is copyright by R.J. but this
  38.         assembly version is a significant rewriting of the original such that
  39.         the addressing modes, use of registers, some data structures, calling
  40.         conventions, display routines, are all different even though the
  41.         functionality is the same. I suggest that you send R.J. the shareware
  42.         donation even if you intend to use this library instead of the
  43.         original C source in a commercial application.
  44.  
  45. CopyLib: This program uses the FileIO requester library. It looks for any
  46.          files ending in ".library" extention (i.e. it looks for library
  47.          files only). If you find and select a library file, it will be
  48.          copied to your boot disk's libs drawer. This provides an easy way
  49.          for WorkBench users to copy custom libraries to their boot disk
  50.          before running an application which uses that library. Of course,
  51.          the requester library (which this program requires) is itself a
  52.          custom library and must be placed in the libs drawer. Not to worry
  53.          though, this program copies the FileIO library to your boot disk
  54.          if it is not already there. (If you want to copy this program to
  55.          another disk, copy the requester.library file as well).
  56.          The only problem that a user might have is not enough room on the
  57.          boot disk for the custom library. If this is the case, then the
  58.          user (you, stupid) must delete any files on the boot disk that he
  59.          deems unnecessary (like the s dir for example. Just kidding!).
  60.          Asm lib by Jeff Glatt.
  61.  
  62. TypeAndTell: This is an example of installing a custom input handler ahead
  63.         of Intuition originally appearing on Fish Disc #73. Input Handlers
  64.         like this can be useful for sending your own "manufactured" keyboard,
  65.         mouse/joy port, menu, etc, events to other applications. Your input
  66.         handler simply makes up the event and passes it on to Intuition, who
  67.         thinks that it is real, and thus sends it to any application waiting
  68.         to receive such an event. This is the main idea behind the "hot keys"
  69.         programs, the "click on the window to make it frontmost" programs,
  70.         and the "record/playback keystrokes" programs. Conversely, you could
  71.         "look for" certain events before Intuition sees them, and filter them
  72.         out. (Perhaps you don't want any programs to ever see the menu button
  73.         being pushed down.) This particular application looks for any rawkey
  74.         (key stroke) events, and speaks out each letter as you type it. I
  75.         suspect that it was written for a blind person. After running the
  76.         program, every time that you press a key, it is spoken. Try running
  77.         the program and then using a word processor (notepad maybe) to see
  78.         the effect. This assembly version is by Jeff Glatt.
  79.         It could be made significantly faster by eliminating
  80.         the use of the translator library (hand translate the letters and
  81.         phrases before assembly). I left it this way because I may use it
  82.         to analyze and speak entire words that the user types in.
  83.  
  84. YACHTC3: This is an assembly language version of the C code game by Sheldon
  85.    Leeman on Fish Disc #158. This version is significantly smaller, but it
  86.    doesn't have the sound options either. Someday I'll hook it up to my
  87.    custom music.library which can play back musical scores with loaded
  88.    samples (plus MIDI), but for now....
  89.  
  90. SAMP: This is an IFF format for storing musical samples without all the in-
  91.    herent limitations of 8SVX. It was devised by dissidents software. It is
  92.    meant to be used in some of our forth-coming musical products. Also,
  93.    included is a utility to convert 8SVX files to SAMP format. This format
  94.    is not backward compatible, and so an 8SVX application cannot use a SAMP
  95.    file.
  96.  
  97. 8SVX: This ascii file is a disassembly of an actual 8SVX sampled data file
  98.       intended to illustrate the exact form of an 8SVX file. If you were to
  99.       include this file in the data section of a program, and write it to
  100.       disc, you would be writing an 8SVX file.
  101.  
  102. StartUps and Libraries: These contain my own custom StartUp code and
  103.    libraries to be used when linking the assembly examples. Many of the
  104.    examples take advantage of the Innovatronic's CAPE assembler PC-relative
  105.    directive. You should make modifications as described in the source if
  106.    using another assembler, or better yet, buy the CAPE assembler.
  107.  
  108.     [Ed note:  I deleted obviously proprietary files such as amiga.lib,
  109.     which compared identical to the same file of that name included
  110.     with the Lattice 5.0 C compiler.  I also deleted all the object
  111.     files because I could not clearly determine which ones came from
  112.     the included source, and which ones did not.  Sorry for any
  113.     inconvenience.   -Fred]
  114.  
  115. TopTenLists: A quick sample of dissidents humor, a morsel, an inkling, a
  116.    small, readily-accessible excerpt of the depraved musings of some
  117.    seriously disturbed individuals.
  118.  
  119.